You are here: Record management > Specializing a rule

Specializing a rule

Use one of the specialization forms when you want to keep the same name as an existing record but modify the context or add a circumstance that will affect rule resolution.

As a best practice, use the Specialization item on the Case Designer's Details tab to circumstance case type rules, as case types should only be circumstanced by a single property.

See: Designer Studio > Process & Rules > Case Management > Case Designer

Overview

The Specialization forms copy an existing record's functionality to a new record with the same name (identifier). You decide whether this new record will have a different context, configuration or circumstance definitions applied.

Use these steps to complete and submit the form:

  1. Choose your Specialization form.
  2. Specialize by class or ruleset.
  3. Define a set of circumstance definitions.
  4. Track changes in PMF (optional).
  5. Create the record.

Note: Because the Specialization forms share a majority of the fields and functionality found on Create form, only exceptions and special cases are outlined in this topic. For general definitions and instruction on how to define a record's configuration and context, see Completing the Create form.

Step 1: Choose a Specialization form

There are two specialization forms available to you based on the record type you want to create:

Both options allow you to copy a record in a new context (class, ruleset, version). In addition, the Specialize by circumstance option lets you define one or more circumstance definitions.

Step 2: Specialize by class or ruleset

If you want to copy an existing record but only change parts of its context, change the values in the Apply to, Add to ruleset and version fields as desired.

The identifier is the only field on the form that is restricted (read-only), however, you may provide an alternative short description.

Step 3: Define a set of circumstance definitions

If you have chosen the Save > Specialize by circumstance menu item, you may still change its class or rulesetwith the following restrictions:

Next, select the appropriate type of circumstance in the radio button list as follows:

Template

Choose the Template radio button when you plan on creating a record that is circumstanced by more than one property value (also referred to as multivariate circumstancing). This option requires you to have at least one template rule created ahead of time that is visible to the selected application layer.

Field

Description

Template

Select a Rule-Circumstance-Template .

Templates specify which combinations of properties may be evaluated by corresponding circumstance definition rules. The list of templates is scoped based on the application layer and apply to class you have specified.

Definition

Select a Rule-Circumstance-Definition that matches your special case (or circumstance).

This definition contains an expression that will be evaluated during rule resolution to determine whether or not your circumstanced version is selected.

Like templates, you must have at least one definition rule created ahead of time that is visible to the selected application layer; it must also map to the selected template rule.

Property

Choose the Property radio button when you plan on creating a record that is circumstanced by a single property value, date property value, date range (or any combination of the three).

Field

Description

Property

Select the name of a property (for example,   .pyStateName) to evaluate. You cannot use aggregate properties or use symbolic page names such as Primary or Parent in this reference.

Simply leave this field blank if you only plan on specifying a date property circumstance with an optional date range. 

Note: If a property is already identified for this rule in another, existing circumstance-qualified rule, use the same property again. You can't use two different properties for qualification of a single base rule.

Value

Enter the expected value of the property in the form of string in quotations.

This is the string that will be evaluated during rule resolution to determine whether or not your circumstanced version is selected. You cannot use a blank or the null value when a property has been specified.

Simply leave this field blank if you only plan on specifying a date property circumstance with an optional date range.

Date Property

Select the name of a date property (type DateTime) to evaluate. This property can be an absolute or a relative reference, and must hold only one value at a time. You cannot use aggregate properties. See As-Of Date processing.

Simply leave this field blank if you only plan on specifying a property circumstance with an optional date range.

Date Value

Use the calendar control to select the expected date value of the date property. This is the value that will be evaluated during rule resolution to determine whether or not your circumstanced version is selected.

Simply leave this field blank if you only plan on specifying a property circumstance with an optional date range.

Use the Add a date range link to define a date range value in conjunction with a property or date property circumstance. Otherwise, we recommended you use the Date range only option below. The Remove date range link is available if you decide your circumstance definition no longer requires a date range.

Date range

Choose the Date range only radio button when you plan on creating a record that is circumstanced by a range of time (evaluated at time of rule execution).

Select a start and end date by using the calendar controls. This is the window of time that will be evaluated against the current system time to determine whether or not your circumstanced version is selected.

After you save the rule, the rule is active during the specified time interval. At all other times, the base rule is active.

Field

Description

Start Date Click the calendar icon to choose the start date, and time (optional) for this rule.
End Date Click the calendar icon to choose the end date, and time (optional) for this rule.

Note: During rule resolution, if two or more date range circumstanced versions (or time-qualified rules) are candidates at the current time and date, the system selects the ones with the nearest end date. Of these, if multiple remaining candidate rules have the same end date, the system picks the candidate with the most recent start date.

For more information, see Circumstances — Concepts and terms and Contrasting time-qualified rules, DateTime circumstances, and historical processing.

Step 4: Track changes in PMF (optional)

Use the Project Management area of the form to link your development changes to items in your PMF worklist. These options are only available if your application is enabled for Project Management tracking .

Project Item

Select an item from the list that you want to associate with this rule. This list is populated from your Project worklist. To update the list with the latest information from your integrated PMF system, use the Refresh link.

Description

This read-only field displays when a User Story item is selected from the Project Item list. Use this field to view more information about the item.

Effort tracking

Two additional fields display in this area when a Bug or Task item is selected from the Project Item list.

Note

Add a development note describing the work done for the item selected in the Project Item list. The text you enter here adds an entry to the Related Updates tab of the item.

To view a list of record changes for your operator without logging into PMF, launch your PMF worklist from the Home Page and click the View Changes link. You can choose display a list of your changes from the My Changes tab or all record changes in the application from the All Changes tab.

For more information about the framework and tracking development progress, see the PDN publication Project Management Framework User Guide.

Step 5: Submit the form

Once you have verified your selections for the record configuration, context and PMF integration, use the Create and open button to submit the form to create the record.

Notes and special cases

Related Topics Link IconRelated information